Collection of Tools & Utilities/Collection of Tools and Utilities.iso/sound/rukc10.zip/MODAC1.DOC

Text File | 1993-03-06 | 16KB | 371 lines

MODAC Copyright 1993 by Cornel Huth. All Rights Reserved.
MODAC1.EXE, 31-Jan-1993.


      MODAC. A shareware mod file player and digital VOC and WAVE file
      player/recorder. Continued use requires registration of $15, US
      DOLLARS ON US BANK. No Credit Cards. Pre-paid orders only. US
      Currency accepted for foreign orders.

      MODAC was written using my RUCKUS-DAC, with Mod extensions, sound library.
      Also available is RUCKUS-MIDI. The graphics is done with my QB/EVGFX,
      level 2, graphics library. The compiler used was Microsoft BASIC 7.1.
      The sound and graphics libraries are shareware, available for download
      on my BBS.

      The latest version Modac, and my other shareware products, may be
      downloaded from The Fortieth Floor BBS, 1(210)684-8065. 16 hours
      of operation: 17:00 to 09:00 Central Time.

      Minimum Requirements:

              IBM PC or compatible
              256K RAM
              DOS 3.0+
              VGA

              Note: See the Additional Notes at the end of this document.

      PC speaker can be used, as can an LPT-DAC on the first LPT port,
      the Disney Sound Source, the AdLib, the Sound Blaster and the
      Sound Blaster Pro. Recording requires either of the Sound Blasters.

      Additional Recommendation:

              IBM AT or compatible (for mod file playback, a 386/25+)
              1MB extended RAM
              XMS 2.0 (3.0+ required for XMS use under 386 memory managers)
              Mouse
              Sound Blaster Pro sound card


      Incompatibilities:

      Use of DOSMAX has been demonstrated to affect performance by as
      much as 50% in mod file playback. 386 memory managers have no
      noticable effect.

      Tandy 2000-series computers may have an incompatible timer chip.
      DMA-only operations should not be affected.

      -- This software was developed on an Intel 486/33, Symphony chipset,
      using the Sound Blaster Pro, and a Tseng VGA card w/ET4000AX.

      Bus-based mouse should not be using a Microsoft MOUSE.xxx driver in
      the version 7.xx. Use 6.xx or the 8.xx versions.

      Some 386 and 486 machines are unable to play Mod data when using both
      DMA and BG modes. Neither of my two machines are affected by this,
      but be aware that some machines will lock up when DMA+BG is used for
      mod file playback.

      Performance:

      Varies, depending on machine. DMA mode offers good across-the-board
      sound performance on VOC/WAVE data, regardless of CPU power. For
      TIMER-0 operation, the more CPU power, the better. AdLib digital
      output demands lots of CPU power.

      For mod processing, the best performance is achieved with foreground
      processing (BG disabled) and DMA processing. 45.5kHz processing rate
      is possible with a 486/33 and an SBPro. With DMA-BG processing, 40kHz
      is about it for a 486/33. In stereo, a mod process rate of 22.75kHz
      is no problem for a 486. If you've never heard a mod played in stereo
      using Modac and an SBPRO, you just haven't heard a mod played.

      You should be aware that over-taxing the machine when playing a
      mod may lock your machine up. Use the CPU RESERVES: status in the
      NOSCOPE scope window. If it doesn't say OKAY, you are over-taxing
      your system.

      The AdLib output level may be rather low so turn up your volume.
      For mod playback you should limit the rate to no more than 10kHz.
      13kHz tops.


      BASIC INFO -----------------------------------------------------

      At start-up, Modac scans for sound devices. The highest numbered
      device is the device that Modac uses by default. Modac knows
      about the following devices:

              0-PC speaker (PCSPK0 at startup)
              1-LPT-DAC
              2-Disney Sound Source
              3-Adlib (ADLIB0 at startup)
              4-Sound Blaster
              5-Sound Blaster Pro

      Note that the LPT-DAC is found if there is a parallel printer
      port, even if no DAC is hooked up to it.

      All PCs have the PC speaker device. Modac has two PC speaker
      drivers. PCSPK0 is the default. PCSPK1 up-samples and offers a better
      quality sound than PCSPK0. Use Ctrl-S to toggle between the two
      when the device is selected. Ctrl-S also toggles the ADLIB0/ADLIB1
      mode. Do not use the -1 versions to playback voc/wave files that are
      already at a high sample rate (over 8kHz or so). The -1 versions
      are for voc/wave playback; there is no difference when playing mods.


      The AdLib is a very slow device for doing digital output. It can
      be done but for best results (as far as the AdLib goes), a fast
      CPU is desired. When using ADLIB1, make sure that the original
      sample is no greater than 8kHz. After loading the VOC/WAV file,
      adjust the desired sample rate so that it is slightly less than
      the actual files sample rate. In some cases ADLIB1 can simply not
      be used. Use ADLIB0 mode if you have too much trouble with ADLIB1.


      Modac down-samples where required so even the PC speaker can
      play a 44kHz stereo WAV file, for example. Adjust the interrupt
      rate in the STATUS BOARD to approximate the desired rate. Modac
      makes on-the-fly adjustments to meet the desired rate. For PCSPK1,
      set the sample rate equal to the actual file sample rate. The
      result will be a 2x up-sample for remarkably clear sound. To
      have the SB (non-PRO) play stereo or high-rate samples, you must
      use timer-0 mode.

      ------------------------------------------------------------------
      Note: To adjust a rate with the mouse, use the LEFT MOUSE BUTTON
      to decrease, and the RIGHT MOUSE BUTTON to increase. In the case
      of adjusting the sample rate, each click results in a 100Hz change.
      For 1000Hz changes, press CTRL while clicking, or for finer
      adjustments, hold down the ALT key while clicking. BG must be enabled
      for adjustments to be made while playing. If you click the right
      mouse button on a volume/level control, all related sliders are
      set to that position.
      ------------------------------------------------------------------

      For overriding Modac defaults or using Modac without a mouse, see
      section II. COMMAND-LINE OPTIONS.

      Device Select.

      Available devices are in low-green. Unavailable are low-red. The
      currently selected device is in hi-green.

           Note: The AdLib card is a supported device in Modac. It is
           also supported in the CHIMPS program. CHIMPS is similar to
           Modac, except that it plays MIDI files (General MIDI, MT-32,
           and CMF).

      To change the current device, click on its button. If the PCSPK or
      ADLIB is currently selected, you can use Ctrl-S to switch between
      the two playback modes available.


      File Select.

      Modac starts up in DIGITAL file mode. The file manager scans for
      all *.VOC or *.WAV files in the current directory. To load a
      file, click on its name in the FILE MANAGER window. Use the
      up/down buttons to scroll through the file list.

      To change file modes, go to the STATUS BOARD and click on the
      file mode button until MOD is displayed.

      To change directories, click on the desired directory name.  To
      move back to the parent directory, click on the .. entry.

      To move to another drive, click on the drive's letter to the
      right of the file entries.

      Foreground/Background Play Mode.

      Before playing, you may want to select background play by click-
      ing on BG in the SPECIAL FUNCTION BOARD. If BG is not selected,
      all computer resources are spent playing. To exit foreground
      play, press Ctrl-Alt.

      BG has the advantage of letting you perform other tasks while the
      playing takes place. You can scan through directories, looking
      fo